home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / zcomd506.arc / ZCOMMDOC.AA < prev    next >
Text File  |  1991-05-06  |  67KB  |  1,771 lines
  1.  
  2.  
  3.                                     Chuck Forsberg
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                    User Manual for
  14.                                         ZCOMM
  15.  
  16.                             Universal Line Printer Edition
  17.  
  18.  
  19.                             ZCOMM Communications Software
  20.  
  21.                                       Featuring
  22.                             TurboLearn(TM) Script Writer,
  23.                  Cybernetic Data Recovery(TM), Error Containment(TM),
  24.                                          and
  25.                                    OverThruster(TM)
  26.  
  27.                      User Supported Communications Software Tools
  28.  
  29.  
  30.  
  31.                                    User Manual for
  32.                                         ZCOMM
  33.                             Universal Line Printer Edition
  34.  
  35.  
  36.                           Copyright 1991 Omen Technology Inc
  37.                                  All Rights Reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                              Omen Technology Incorporated
  44.  
  45.  
  46.  
  47.                             The High Reliability Software
  48.                             Box 4681 Portland Oregon 97208
  49.                               VOICE: 503-621-3406 :VOICE
  50.                   TeleGodzilla Modem: 621-3746 Speed 1200,2400,19200
  51.                    Compuserve:70007,2304  GEnie:CAF  BIX:cforsberg
  52.                           UUCP: ...!tektronix!reed!omen!caf
  53.            Copyright 1984 to 1991  Omen Technology INC All Rights Reserved
  54.  
  55.  
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc                                      Chapter 0
  59.  
  60.  
  61.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                    2
  63.  
  64.         1.  INTRODUCTION
  65.  
  66.                                         ZCOMM
  67.                    Industrial Stength Communications Shareware(TM)
  68.  
  69.         ZCOMM helps collect, control, and transmit information with a minimum
  70.         of time, hassle, and expense.  Concise commands and unobtrusive
  71.         displays facilitate telecommunications instead of distracting.
  72.  
  73.         When it comes to file transfers, just remember who wrote YMODEM and
  74.         ZMODEM.  Two decades of telecommunications knowledge are distilled in
  75.         ZCOMM.
  76.  
  77.  
  78.  
  79.                            State of the Art File Transfers
  80.  
  81.         "ZMODEM is the overall winner"
  82.                                -BYTE Magazine, Feb 1989
  83.  
  84.         Two decades of communications experience are distilled in ZCOMM.
  85.         ZCOMM transfers files quickly and surely under real world conditions,
  86.         not just across tabletops.  Unsolicited customer testimonials
  87.         chronicle accurate file transfers under conditions that crash other
  88.         programs, thanks to Omen Technology's Cybernetic Data Recovery(TM)
  89.         logic enhancements and rigorous stress testing.
  90.  
  91.         How often has your modem disconnected when you were within a few bytes
  92.         of finishing a long, expensive file transfer?  With ZMODEM-90(TM) you
  93.         can resume the transfer from where you were cut off, without wasted
  94.         time or extra phone charges.  If the transfer aborted because you ran
  95.         out of disk space, ZMODEM can recover from that too!
  96.  
  97.         ZMODEM transfers files and commands with a user friendly interface.
  98.         Unlike traditional protocols, only one command or menu choice is
  99.         needed to transfer files or download commands.
  100.  
  101.         "Pro-YAM's AutoDownload feature for ZMODEM (and KERMIT) has got me
  102.         completely addicted."
  103.  
  104.         ZMODEM protects your data with a 32 bit CRC, five orders of magnitude
  105.         more accurate than the CRC-16 used by other protocols, and billions of
  106.         times more sensitive than XMODEM checksum.  Unlike "me too" protocols
  107.         developed to compete with ZMODEM, all ZMODEM messages are protected
  108.         with CRC.
  109.  
  110.         ZMODEM provides high throughput and full integrity with timesharing
  111.         systems, high speed modems, and packet switched networks.  Unlike
  112.         other protocols, ZMODEM's does not compromise reliability to get high
  113.         speed.
  114.  
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  118.  
  119.  
  120.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                    3
  122.  
  123.         Omen Technology's ZMODEM-90(TM) extensions accelerate transfers and
  124.         enhance flexibility.
  125.  
  126.         ZMODEM compression provides spectacular throughput increases on
  127.         suitable files.
  128.  
  129.         Other ZMODEM features include text file translation, selective
  130.         transfer of modified files, and remote file maintenance.  A single
  131.         command can update an entire directory tree, creating new directories
  132.         as necessary.
  133.  
  134.         Security authentication* disables Trojan Horse attacks.
  135.  
  136.         ZMODEM supports world wide operations by preserving the exact file
  137.         contents and modification date, unaffected by crossing time zones.
  138.  
  139.         Omen Technology provides complimentary Unix and VAX/VMS ZMODEM servers
  140.         in source and binary formats.
  141.  
  142.         "Here's the simple fact. Zmodem is the state-of-the-art protocol for
  143.         microcomputers.  It's the protocol of choice.  Forget the old dogs.
  144.         It's fast and bullet-proof."
  145.                  -John C. Dvorak, INSIDE TRACK, PC Magazine June 1989
  146.  
  147.         "without doubt the number one protocol"
  148.                           -Boardwatch Magazine January 1990
  149.  
  150.         Competitors hype their undocumented proprietary protocols; experienced
  151.         BBS operators know ZMODEM is the only high performance protocol that
  152.         survives on the streets.  ZMODEM's convenience, speed and reliability
  153.         have made it the protocol of choice for bulletin boards, BIX, GEnie,
  154.         Portal, Delphi, Unison, and other information utilities.
  155.  
  156.                         XMODEM: Lingua Franca for Old Programs
  157.  
  158.         ZCOMM supports Ward Christensen's XMODEM protocol with Cybernetic Data
  159.         Recovery(TM) and automatic file name generation.  Omen Technology's
  160.         exclusive Cybernetic Data Recovery transfers files under conditions
  161.         that crash other programs.
  162.  
  163.          + XMODEM CRC-16 is more accurate than simple checksum.  But even with
  164.            CRC-16, an error of just two bits can corrupt data sent with
  165.            XMODEM.  Cybernetic Data Recovery catches and corrects many errors
  166.            that confound other programs.
  167.  
  168.          + True YMODEM(TM) batch file transfers preserve the exact file name,
  169.            file length and creation date.
  170.  
  171.          + XMODEM-1k and YMODEM-1k 1024 byte packets increase XMODEM
  172.            throughput.
  173.  
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  177.  
  178.  
  179.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                    4
  181.  
  182.                              Kermit: Rx for Brain Damage
  183.  
  184.         Kermit transfers ASCII and binary files with IBM, CDC, Cray, ICL,
  185.         Harris, Honeywell, Pr1me, Tandem, Univac and other traditional
  186.         mainframes that do not support XMODEM.
  187.  
  188.         While not as fast as ZMODEM, Kermit is more reliable than XMODEM.
  189.         ZCOMM's 16 bit Kermit CRC is thousands of times more accurate than
  190.         other programs' 6 bit checksum.
  191.  
  192.          + Convenient Kermit AutoDownload deciphers the sending program's
  193.            Kermit dialect, saving keystrokes and frustration.  (Dialect
  194.            incompatibilities often confound Kermit users.)
  195.  
  196.          + Long Packet Kermit speeds file transfers with IBM, CDC, and Cray
  197.            mainframe systems.  Sliding Windows are also supported.  Kermit
  198.            Server Access functions support low cost networking.
  199.  
  200.                             Swiss Army Knife for Protocols
  201.  
  202.  
  203.          + Extended Quick-B streaming protocol slashes CompuServe download
  204.            costs up to 60 per cent or more.
  205.  
  206.          + OverThruster(TM) accelerator speeds XMODEM and YMODEM downloads
  207.  
  208.          + ZCOMM supports bulletin boards and traditional programs with
  209.            Telink/FIDO, MODEM7 batch, WXMODEM (Windowed XMODEM), and SEAlink
  210.            file transfer protocols.
  211.  
  212.                                      Data Capture
  213.  
  214.         ZCOMM's Full-Time Capture Buffer(TM) saves scrolled data other
  215.         programs lose.  You can scroll, page, and string search to cut and
  216.         paste captured information.
  217.  
  218.         Omen's Error Containment(TM) technology minimizes errors caused by
  219.         line hits and their effects on automatic scripts.
  220.  
  221.         ZCOMM captures text with many choices of parity bit and control
  222.         character editing.  ZCOMM can capture binary data without protocols.
  223.         ZCOMM does not limit the length of captured files.
  224.  
  225.  
  226.                                Controlling Information
  227.  
  228.         ZCOMM's Full-Time Capture Buffer(TM) lets you flip back and forth or
  229.         search, scanning two hundred messages from bulletin boards in a couple
  230.         of minutes.  (It has to be seen to be believed.) To compose a reply,
  231.         call your favorite editor (the one you've already learned!) as a
  232.         subroutine without losing your place.
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  236.  
  237.  
  238.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                    5
  240.  
  241.         ZCOMM's high speed screen driver- makes life pleasant:
  242.  
  243.         + Easy on the eyes: ZCOMM supports No Flicker displays, up to 450 per
  244.           cent faster than DOS
  245.  
  246.         + VT220, VT102, VT100, Wyse, TTY 5425, ANSI, Z19, VT52, TI 940, IBM
  247.           3101, Televideo 9xx, and ADM3a emulation.
  248.  
  249.         + Supports 132 columns and advanced displays (114x60, etc.)
  250.  
  251.         + VT100 character graphics and keyboard mapping support "visual"
  252.           programs.  Unlike most "VT100" emulators, ZCOMM correctly displays
  253.           EDT, All-In-1, SCO setcolor, and DEC Store on an XT even at 19200
  254.           baud.
  255.  
  256.         + Hardcopy Terminal Emulation previews printer output.
  257.  
  258.         + Visual (silent) bell preserves domestic tranquillity
  259.  
  260.         + Settable number of lines and columns, border color, default colors,
  261.           autowrap, keyboard mapping enable.
  262.  
  263.         Full pathnames, directories, and wildcards support file transfers and
  264.         utility commands.
  265.  
  266.         ZCOMM can search files for lines matching a string, insensitive to
  267.         case.
  268.  
  269.  
  270.                                Transmitting Information
  271.  
  272.  
  273.         + Dual stack Command Recall saves your keyboarded host commands in a
  274.           history file for search, recall, editing, and reentry.
  275.         + Convenient Split Screen option- allows responsive local editing of
  276.           input lines before transmission.
  277.         + A rich palette of editing and timing modes permit file and message
  278.           upload, even to fussy microcomputer Bulletin Boards.
  279.         + Remote access for file transfers and DOS program execution with baud
  280.           rate detection and three passworded security levels.
  281.         + Outcall Queue intersperses scheduled outgoing calls with incoming
  282.           messages on one modem line.
  283.  
  284.  
  285.         1.1  Other Features
  286.  
  287.  
  288.         Interrupt driven modem input allows High speed operation with file
  289.         transfer and conversational terminal operation at 19200 bps and above.
  290.         ZCOMM fully exploits advanced features of the new UART chips for best
  291.         operation at high speeds.
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  295.  
  296.  
  297.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                    6
  299.  
  300.         A real-time status line displays column, row, time, elapsed time,
  301.         transmission speed, and other important information.
  302.  
  303.         Soft keys provide convenient execution of common commands.
  304.  
  305.         ZCOMM is written in C for performance, portability and
  306.         maintainability.  ZCOMM loads quickly from a moderately sized
  307.         executable file with no cumbersome overlays.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc                          Chapter 1 Registration
  354.  
  355.  
  356.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                    7
  358.  
  359.         2.  ZCOMM REGISTRATION
  360.  
  361.         ZCOMM is a user supported program developed and supported by Chuck
  362.         Forsberg.  ZCOMM is not and never has been public domain.
  363.  
  364.         Registration buys you:
  365.  
  366.            + Your own unique ZCOMM Serial Number Password (ZSNP).  Your ZSNP
  367.              may be applied to copies of ZCOMM to be run on a single machine.
  368.  
  369.                 + Serialized of ZCOMM deactivates the registration request
  370.                   display and the pause afterwards.
  371.  
  372.                 + Serialization activates the egrep, egrepm, expand, split,
  373.                   and ss commands and the outcall queue.  Features denoted
  374.                   with ** are available in serialized copies of ZCOMM.
  375.  
  376.                 + Serialization more than doubles the circular buffer size.
  377.  
  378.            + A software disk with the current version of ZCOMM, the putsnp
  379.              program to serialize your copy of ZCOMM with your ZSNP, and the
  380.              tree structured "flash-up" help processor and help file included
  381.              in ZCOMMHLP.ARC.
  382.  
  383.            + The complete Professional-YAM User Manual, more than 200 Typeset
  384.              pages, with many chapters not included here, ready for insertion
  385.              into a PC size binder.
  386.  
  387.            + The Pro-YAM Crib Sheet.
  388.  
  389.            + A ZCOMM registration is worth $40.00 when upgrading to
  390.              Professional-YAM.  The $99.00 upgrade includes the Pro-YAM
  391.              software disks and license.  You will already have the manual
  392.              from your ZCOMM registration package.
  393.  
  394.            + A warm fuzzy feeling arising from the knowledge you have
  395.              supported the advancement of ZMODEM.
  396.  
  397.         REGISTRATION DETAILS:
  398.  
  399.            + Basic registration (ZSNP, disk, manual pages): $40.00
  400.  
  401.            + Optional Custom Binder: $10.00
  402.  
  403.            + Optional 3.5 inch diskette: $5.00
  404.  
  405.            + Domestic/Canada Surface Shipping: Free with prepaid orders
  406.  
  407.            + International Air Mail (most countries): $15.00[1]
  408.  
  409.  
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc                          Chapter 2 Registration
  413.  
  414.  
  415.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                    8
  417.  
  418.            + Optional Domestic UPS Second Day AIR: $5.00
  419.  
  420.            + Credit Card/C.O.D. S&H:  $5.00
  421.  
  422.         Don't bother scrounging for an envelope, use the INSTANT MAILER
  423.         included in this archive!
  424.  
  425.  
  426.         2.1  Legal Necessities
  427.  
  428.         ZCOMM may not be modified, patched, hacked, disassembled, decompiled,
  429.         or otherwise reverse engineered, or sold, without prior written
  430.         permission by Omen Technology Inc.  This prohibition applies to any
  431.         theft of the intellectual property and trade secrets contained in
  432.         ZCOMM by decompilation, disassembly, or any other form of reverse
  433.         engineering including but not limited to profiling, tracing, data
  434.         analysis, or monitoring the operation of ZCOMM.
  435.  
  436.         The only legitimate way to disable the opening advertisement in ZCOMM
  437.         is to insert an authorized SNP obtained from Omen Technology into
  438.         ZCOMM with the putsnp program.  Any other suppression or modification
  439.         of the opening screen is illegal, unethical, and prohibited.
  440.  
  441.         Distribution of programs and/or instructions on how to modify, patch,
  442.         disassemble, decompile, or otherwise reverse engineer ZCOMM without
  443.         prior written permission by Omen Technology Inc is a theft of services
  444.         and a violation of federal copyright law, and will be referred to the
  445.         FBI for investigation and prosecution under federal conspiracy
  446.         statutes.  Applicable RICO law provides for treble damages and
  447.         recovery of attorney's fees.
  448.  
  449.         Distribution of ZCOMM in any medium without this documentation file
  450.         constitutes an unauthorized modification.
  451.  
  452.         Students may use unregistered copies of ZCOMM in the discharge of
  453.         assigned coursework for the duration of the course without obligation
  454.         to register.  Otherwise, individuals may use ZCOMM with only a moral
  455.         obligation to register their copy with Omen Technology once they find
  456.         it useful.  You may distribute the unmodified ZCOMM*.ARC archive
  457.         files[2] to as many as you wish, or post them on bulletin boards, etc.
  458.         Businesses must register their copies of ZCOMM.
  459.  
  460.  
  461.  
  462.         ______________________________________________________________________
  463.  
  464.          1. $25.00 to Australia etc. if binder included due to higher cost.
  465.  
  466.          2. The archives may be converted to other storage or archive formats,
  467.             including "zipping", provided no files are modified or removed.
  468.  
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc                          Chapter 2 Registration
  472.  
  473.  
  474.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                    9
  476.  
  477.         3.  ZCOMM's Big Brother
  478.  
  479.         ZCOMM is the Little Brother of Professional-YAM.  As powerful as ZCOMM
  480.         is, more powerful than other user supported software, it pales beside
  481.         Omen Technology's commercial Professional-YAM software.
  482.  
  483.         Pro-YAM's TurboDial(TM) script language provides state of the art real
  484.         time pattern recognition, "regular expiression" string parsing, script
  485.         development aids, script encryption, queue management, extensive
  486.         logging facilities, and finely tuned security control unmatched in the
  487.         industry.
  488.  
  489.         Fortune 500 corporations use these exclusive features to support large
  490.         PC based telecommunications projects involving attended and unattended
  491.         operation.
  492.  
  493.         Specialized utility commands allow Pro-YAM and a PC or DG/One portable
  494.         to replace data line monitors in many applications.  Pro-YAM supports
  495.         Echoplex uploads and high speed data dumps in addition to the uniquely
  496.         accurate and robust XMODEM, YMODEM, ZMODEM, and Kermit protocol
  497.         transfers shared with ZCOMM.  Pro-YAM has many powerful utility
  498.         commands that earn it the sobriquet Integrated Communications Tools.
  499.  
  500.         Pro-YAM is available with the Tymnet X.PC link level protocol for
  501.         multiple, concurrent data transfers.
  502.  
  503.         Omen Technology also markets highly compatible Unix and Xenix flavors
  504.         of Pro-YAM.
  505.  
  506.         Omen Technology's Demand Upgrade(TM) technology and small company
  507.         responsiveness meet the support needs of a growing base of demanding
  508.         customers.
  509.  
  510.         Professional-YAM is a superset of ZCOMM; applications and scripts
  511.         developed on ZCOMM will operate with Pro-YAM.
  512.  
  513.         This ZCOMM manual omits descriptions of many Pro-YAM features not
  514.         included in ZCOMM.  The special symbol * denotes Pro-YAM features not
  515.         included in ZCOMM.
  516.  
  517.         Pro-YAM features not included in ZCOMM include X.PC, encryption,
  518.         CryptoScript(TM) capability, Password Guardian(TM), logs, the ap, apd,
  519.         fget, fput, kbdmon, link, on, portx, purgek, quit, restime, restrict,
  520.         timestamp, trs, and usq commands, and certain vertical application and
  521.         security related features.  (Newer versions of ZCOMM include the
  522.         logging facility.)
  523.  
  524.         In some places you will see references to a fake Chapter 99.  Pro-YAM
  525.         manual chapters not included in this document are designated by
  526.         Chapter 99.
  527.  
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc                                 Chapter 3 ZCOMM
  531.  
  532.  
  533.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                   10
  535.  
  536.         ZCOMM registration can be upgraded to Pro-YAM as described in the
  537.         previous chapter.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                      Chapter 3 Flavors of ZCOMM
  590.  
  591.  
  592.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                   11
  594.  
  595.         4.  FLAVORS OF ZCOMM
  596.  
  597.         4.1  IBM PC Family and Clones
  598.  
  599.         ZCOMM.EXE and ZCOMM run under PC-DOS and compatible operating systems
  600.         using PC compatible 8250 family serial ports.  They exploit the new
  601.         Intel 82510 and National NS16550AN serial interface integrated
  602.         circuits for improved high speed operation, especially with memory
  603.         resident software and extended memory ramdisks.
  604.  
  605.         ZCOMMXPC.EXE supports the Tymnet X.PC packet protocol.  This version
  606.         uses the Tymnet Packet Driver and will not initialize unless the
  607.         packet driver has been loaded.  The X.PC version lacks the bdump and
  608.         link commands.  The !~ command does not allow DOS subprograms to
  609.         access the serial line with the DOS ctty command.
  610.  
  611.         ZCOMM and its support programs are also available for OS/2 protected
  612.         mode.
  613.  
  614.         4.2  Xenix/Unix
  615.  
  616.         ZCOMM for 32 bit Unix systems supports a number of advanced features,
  617.         including X windows[1] large memory, recursive wild card expansions
  618.         and ZMODEM transfers with LZW data compression.  Unix and Xenix
  619.         flavors of ZCOMM reflect the deep fundamental differences between
  620.         single tasking PC-DOS and Xenix.  Notable differences are in keyboard
  621.         handling, screen emulation, and real-time aspects.  Properly written
  622.         TurboDial(TM) Scripts may be used with any flavor of ZCOMM.  Omen
  623.         Technology Inc provides binary executables for SCO System V Xenix (286
  624.         and 386) and Interactive Systems 386/ix.  The 386/ix flavor supports
  625.         Microport SYS V/386 and similar systems.
  626.  
  627.         Please contact Omen Technology Inc for reasonably priced source code
  628.         for other versions of Unix.
  629.  
  630.  
  631.         4.3  VAX/VMS
  632.  
  633.         VMS Professional-YAM supports dial out applications with functionality
  634.         similar to Unix flavors.
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.         __________
  643.  
  644.          1. Under xterm(1).
  645.  
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc                      Chapter 4 Flavors of ZCOMM
  649.  
  650.  
  651.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                   12
  653.  
  654.         4.4  ZCOMM
  655.  
  656.         ZCOMM is a shareware subset of ZCOMM available for PC-DOS.  It lacks
  657.         the ap, apd, fget, fput, link, kbdmon, obey, on, quit, purgek,
  658.         restime, restrict, timestamp, trs, and usq commands.  Arbitrary
  659.         variable names and security features are not supported.  Certain
  660.         commands and features are available only in registered copies.  The
  661.         special symbol * denotes features not included in ZCOMM.  Features
  662.         denoted with ** are available in registered copies of ZCOMM.
  663.  
  664.         Some ZCOMM users choose to upgrade to Professional-YAM.  Omen's ZCOMM
  665.         to Pro-YAM upgrade policy protects your investment in ZCOMM
  666.         registration.  The ZCOMM to Pro-YAM upgrade consists of a Pro-YAM
  667.         serial number and diskette set.  The $99.00 price is the same as the
  668.         difference between Pro-YAM purchase and ZCOMM registration.
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc                     Chapter 4 Design Philosophy
  708.  
  709.  
  710.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                   13
  712.  
  713.         5.  DESIGN PHILOSOPHY
  714.  
  715.         ZCOMM is a Communications Tool.  Once learned, ZCOMM's command
  716.         interface is more powerful, faster, and less cumbersome than a menu
  717.         interface.  Indeed, menus comprehensive enough to describe all the
  718.         nuances of ZCOMM's capabilities would take up more memory than most
  719.         microcomputers can afford.  In addition, remote operation of ZCOMM
  720.         would be excruciatingly slow due to transmission delays displaying the
  721.         appropriate menu pages.
  722.  
  723.         ZCOMM's look and feel has been influenced by the MODEM series of
  724.         programs, the Unix(TM) Operating System, the Berkeley Editor (vi),
  725.         CP/M(TM), PC-DOS, and ANSI standards.
  726.  
  727.         Function keys F1 and F2 have been assigned with a logical grouping.
  728.         Wherever meaningful, F1 exits from a function, and F2 enters the
  729.         logical "next" function.  From the command prompt, F2 enters the term
  730.         function, and from there another F2 enters the review function.  Once
  731.         in the review function (assuming it was called from the term
  732.         function), F1 exits back to the term function, from where another F1
  733.         exits to the command prompt.
  734.  
  735.         Another ethic guiding ZCOMM's design is respect for the user's
  736.         information.  The user's data is, after all, precisely what a modem
  737.         program is all about.  Status information is limited to one CRT line
  738.         to allow maximum screen size for data.  Fancy display modes such as
  739.         reverse video are used sparingly to avoid distracting from the user's
  740.         work.
  741.  
  742.         If you seek a video arcade modem game, ZCOMM will disappoint you.
  743.  
  744.         5.1  Circular Buffer
  745.  
  746.         The circular buffer remotely resembles the linear "capture buffer"
  747.         used by other modem programs.  Many ZCOMM commands involve the
  748.         circular buffer, including the t, f, wait, ki, kill, w, review, and
  749.         close commands.
  750.  
  751.         The term function uses the circular buffer as a first in, first out
  752.         (FIFO) buffer for data arriving from the remote.  The circular
  753.         organization of this buffer makes the most recent data always
  754.         available for review and arbitrary writing to disk files.
  755.  
  756.         When the circular buffer has been filled and the XOFF character sent
  757.         to the remote, ZCOMM writes the contents of the circular buffer to the
  758.         capture file if a capture file has been opened.  ZCOMM then checks
  759.         whether any characters remain to be written to the printer.  When both
  760.         of these checks are satisfied, ZCOMM then sends an XON character to
  761.         the remote to resume the transmission of data.
  762.  
  763.         Keyboarding ALT-W or enabling j mode writes the contents of the
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                       Chapter 5 Circular Buffer
  767.  
  768.  
  769.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                   14
  771.  
  772.         circular buffer to the capture file without waiting for the circular
  773.         buffer to fill up first.
  774.  
  775.         The large storage capacity of the circular buffer may be used to
  776.         review the most recent data captured from the remote.  The review
  777.         command allows one to page back and forth through the data captured
  778.         from the remote.  Forward and backward string searches make it easy to
  779.         locate important text.  The review command also allows segments of the
  780.         data in the circular buffer to be selectively saved on disk (cut and
  781.         pasted).  Scripts can search and mark text captured from the remote
  782.         with the full power of regular expression pattern matching.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  826.  
  827.  
  828.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                   15
  830.  
  831.         6.  ROSETTA STONE
  832.  
  833.         Alphanumeric An alphanumeric character is either a letter or a decimal
  834.             digit 0 to 9.
  835.  
  836.         Baud A baud is a signaling unit conveying one or more bits of
  837.             information.  Baudrate is commonly (and usually incorrectly)
  838.             interchanged with bits per second.
  839.  
  840.         BPS is an abbreviation for "bits per second", a measure of
  841.             transmission speed.  ASCII Asynchronous transmission generally
  842.             uses 10 bits to transmit each character, so the speed in
  843.             characters per second is one tenth the speed measured in bits per
  844.             second.
  845.  
  846.         Capture The term function captures data from the remote into the
  847.             circular buffer.  This data may be paged back and forth with the
  848.             review function, or written to a disk file.
  849.  
  850.         Character Escape is a sequence of characters initiated by a backslash
  851.             character used to represent a control character or programmable
  852.             string using printable characters.  Character escapes are
  853.             described in Chapter 26.
  854.  
  855.         CPMEOF A control character (hex 1A) added to the end of text files by
  856.             traditional microcomputer programs.  This practice was popular
  857.             with the Digital Research CP/M 8 bit operating system.
  858.  
  859.         Crash Recovery(TM) refers to the ZMODEM File Transfer Protocol's
  860.             ability to resume file transfers that have been interrupted by a
  861.             line disconnect from the point where the transfer was interrupted.
  862.  
  863.         Cyclical Redundancy Check (CRC) is a datum (16 or 32 bits) generated
  864.             by a cyclic code.  The CRC-16 extension to the Ward Christensen
  865.             XMODEM protocol provides a high level of data integrity.  CRC-16
  866.             guarantees detection of all single and double bit errors,  all
  867.             errors with an odd number of error bits, all burst errors of
  868.             length 16 or less, 99.9969% of all 17-bit error bursts, and
  869.             99.9984 per cent of all possible longer error bursts.  The actual
  870.             performance is even better because the errors that sneak by CRC-16
  871.             are often detected by the other error checks simultaneously
  872.             applied by ZCOMM's Cybernetic Data Recovery(TM).  ZMODEM's 32 bit
  873.             CRC provides five orders of magnitude more accurate error
  874.             detection than XMODEM's CRC-16 a billion times more accurate than
  875.             8 bit checksum used by standard XMODEM..
  876.  
  877.         Default is a choice a program makes for you if you do not explicitly
  878.             make a contrary choice.
  879.  
  880.         Download is the transfer of data from the host system down to your
  881.             computer.
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                         Chapter 6 Rosetta Stone
  885.  
  886.  
  887.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                   16
  889.  
  890.         DTR is an abbreviation for Data Terminal Ready.  Data Terminal Ready
  891.             is a signal sent by the computer to the modem to condition it to
  892.             accept commands or answer an incoming call.  When DTR is "dropped"
  893.             (switched off), the modem should disconnect from the line.
  894.  
  895.         Execute When a string parameter is executed, it is normally sent to
  896.             the remote (modem).  If it begins with "@", the remainder is
  897.             executed as a ZCOMM command.
  898.  
  899.         Filespec Some ZCOMM commands instruct a remote Kermit server program
  900.             to send, receive, print, type, or delete one or more files.  The
  901.             syntax of this specification is defined by the remote Kermit
  902.             server program, not ZCOMM.  If filespec contains spaces, filespec
  903.             must be enclosed by double quotes.
  904.  
  905.         Flow Control restrains the speed of transmission to prevent loss of
  906.             data when a fast sender must send to a slower receiver.  Hardware
  907.             signals, control characters, and protocol handshakes can be used
  908.             to provide restraint, singly or in combinations.
  909.  
  910.             SEE ALSO: handshake command, zmodem w parameter, Flow Control
  911.             Chapter 14
  912.  
  913.         Functions are operations supported by ZCOMM, such as a dir, type, s,
  914.             r, or t (term) command.  A command may set or reset mode[s],
  915.             change a parameter, or perform a function.
  916.  
  917.         Host Operation allows remote access of files and programs.
  918.  
  919.         Iff If and only if.
  920.  
  921.         Integrity in a data transfer protocol refers to the ability of the
  922.             protocol to guarantee a correct data transfer provided both sender
  923.             and receiver report a successful transfer.  Integrity is a
  924.             different measure of a file transfer protocol than robustness,
  925.             which is a measure of a protocol's ability to complete the
  926.             requested transfers in the presence of errors, independent of the
  927.             probability of undetected errors.
  928.  
  929.         Kermit ia an error correcting batch file transfer protocol developed
  930.             at Columbia University and elsewhere.  The Kermit protocol
  931.             supports text and binary file transfers with many mainframe
  932.             computers whose hardware and operating software preclude
  933.             implementation of high performance protocols.
  934.  
  935.         Line Hit A burst of noise on a telephone line may generate modem data
  936.             errors.  A single "line hit" may garble dozens of characters.
  937.             ZCOMM's Error Containment(TM) technology may be used to reduce the
  938.             number of characters garbled by line hits suffered in terminal
  939.             emulation data capture.
  940.  
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc                         Chapter 6 Rosetta Stone
  944.  
  945.  
  946.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                   17
  948.  
  949.         Modes Many modes are available to modify the way the term function
  950.             receives, displays, transmits, and stores data.
  951.  
  952.         N.B. Nota Bene, Latin for "note well" or "take notice".
  953.  
  954.         Options Options apply to the Kermit, s, sx, sb, s7, st, r, rx, r7, rb,
  955.             and rc protocol file transfer commands.
  956.  
  957.         q.v. Quod Vide is Latin for "which see", an invitation to consult
  958.             information on the subject mentioned.
  959.  
  960.         Pathname is a complete file name, optionally including disk and/or
  961.             directory names.
  962.  
  963.             EXAMPLE: c:/ZCOMM/PHODIR.t
  964.  
  965.  
  966.         Pathspec ... A pathspec consists of zero or more pathnames.
  967.  
  968.             Unambiguous and ambiguous (with wildcard characters) pathnames may
  969.             be specified in any combination.  The wildcard filename characters
  970.             * and ?  are allowed as described in the IBM DOS manual chapter
  971.             "Global Filename Characters".  In DOS, only the filename portion
  972.             of the pathname may contain wildcards.
  973.  
  974.             EXAMPLE: src/cmd/*.c is legal; src/*/foo.c is not.
  975.  
  976.  
  977.             On 32 bit Unix systems, ZCOMM expands "*" and "?" the way the
  978.             shell does.  All the shell wildcards may be used including
  979.             multiple wildcards, wildcards in directories, and ranges.  ~user
  980.             expands to the login directory of user, and ~ expands to your home
  981.             directory.  In addition, `command` takes the output of command as
  982.             a series of pathnames.
  983.  
  984.             EXAMPLE: dir */[a-i]* displays all files starting with "a" to "i"
  985.             in all subdirectories immediately below the current directory.
  986.  
  987.  
  988.             An empty pathspec represents all files in the current directory on
  989.             the current disk.  A disk identifier without any file names
  990.             represents all files on that disk's current directory.  A
  991.             directory pathname expands to all files in the specified
  992.             directory.
  993.  
  994.             Sequences of the form %svar are replaced by the value (possibly
  995.             empty) of the string parameter svar.  If svar is not a string
  996.             parameter, no substitution is made.
  997.  
  998.             A pathspec may contain any combination of the above, separated by
  999.             spaces or tabs.
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1003.  
  1004.  
  1005.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                   18
  1007.  
  1008.             If pathspec includes a disk specifier (such as a: or b:), ZCOMM
  1009.             checks the disk specifier against the list of permissible disk
  1010.             specifiers in the string parameter disks.
  1011.  
  1012.             The various filename expansions are especially useful in the
  1013.             context of commands such as wc, sum, crc, find, sb, and sz.  For
  1014.             example, wc applies to all files in the current directory, and
  1015.             wc dir applies to all files in dir.
  1016.  
  1017.             ZCOMM pathnames may use / or \ to delimit directories.
  1018.  
  1019.         Regular Expressions control pattern matching and grouping of text by
  1020.             the ss and egrep commands.  "Magic" characters specify the pattern
  1021.             matching and grouping processes.
  1022.  
  1023.         Remote refers to the machine or terminal with which ZCOMM is
  1024.             communicating.  This could be a direct RS-232 connection to a
  1025.             local terminal, micro, mini, or mainframe, or a timesharing system
  1026.             accessed through a modem and a global packet switched network.
  1027.  
  1028.         Restraint See "Flow Control" above.
  1029.  
  1030.         Restricted For security reasons, ZCOMM is restricted to prevent
  1031.             unauthorized dial-in users from accessing private data or crashing
  1032.             the system.  Certain commands are illegal when ZCOMM is
  1033.             restricted, and only specified disk drives and directories may be
  1034.             accessed.
  1035.  
  1036.         Review Function Characters output from the remote may be paged and
  1037.             searched online with the review function.  This data may also be
  1038.             cut and pasted to disk files.
  1039.  
  1040.         Robustness in a file transfer protocol refers to the protocol's
  1041.             ability to complete transfers in the presence of errors induced by
  1042.             line noise or other sources.  Robustness is a different measure of
  1043.             a file transfer protocol than integrity, a measure of the
  1044.             probability of correct data transfer given a successful completion
  1045.             of the transfer process.
  1046.  
  1047.         Script A script is a set of commands that control dialogues with the
  1048.             user or a remote system.
  1049.  
  1050.         Script Level refers to the degree of nesting of scripts.  Level 0 is
  1051.             called by the user directly, and each higher level is executed by
  1052.             a gosub or other command from the previous level.
  1053.  
  1054.         Shell Escape is a DOS command or program called as a subroutine from
  1055.             ZCOMM via a DOS Gateway.  The phrase "shell escape" comes from the
  1056.             Unix(TM) Operating System, whose command interpreter is called
  1057.             "the shell".
  1058.  
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1062.  
  1063.  
  1064.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                   19
  1066.  
  1067.         Soft Keys Strings or commands may be assigned to the Soft Keys with
  1068.             set commands, including those in the telephone directory "setup"
  1069.             entry executed each time ZCOMM starts.  ZCOMM recognizes the forty
  1070.             function key codes produced by the function keys F1 to F12.  FS1
  1071.             to FS12 are obtained with a Shift key, FC1 to FC12 are obtained
  1072.             with the Ctrl key, and FA1 to FA12 are obtained with the Alt key.
  1073.             The cursor keys and extra function keys on 101 key Extended
  1074.             Keyboards are also recognized.
  1075.  
  1076.             Strings or commands may be assigned to BS, ESC, Ins, Del, Home,
  1077.             End, Up, Down, Left, Right, PgUp, and PgDn, overriding their
  1078.             normal functions in the term function.
  1079.  
  1080.         String Some commands take a string argument.  If a string argument
  1081.             contains spaces, tabs, and a semicolon, it must be enclosed by
  1082.             double quotes (shift single quote on the IBM PC keyboard).
  1083.             Control characters may be included in strings with character
  1084.             escapes similar to those used by the C Programming Language.
  1085.  
  1086.         Term Function ZCOMM's Term Function provides the conversational
  1087.             "connection" between the user and the remote.  The term function
  1088.             captures data from the remote into ZCOMM's circular buffer from
  1089.             whence it may be displayed, printed, stored in a disk file, or
  1090.             searched, cut and pasted by the review function.
  1091.  
  1092.         Upload is a transfer of data from your computer up to the host system.
  1093.  
  1094.         Wild Card Many commands allow wild card file names in their pathspec
  1095.             (q.v.).
  1096.  
  1097.         Writing When a receive file is open as a result of a create or t
  1098.             filename command, data in the circular buffer is written out to
  1099.             the receive file when the circular buffer fills up or when a w or
  1100.             ALT-W command is given.
  1101.  
  1102.         XMODEM The Ward Christensen file transfer protocol uses 128 byte
  1103.             packets, one byte control messages, and a one byte arithmetic
  1104.             checksum.
  1105.  
  1106.         XMODEM/CRC A synonym for the enhanced Ward Christensen XMODEM protocol
  1107.             using a Cyclic Redundancy Check (CRC-16).  Newer programs support
  1108.             CRC-16 for better data integrity, but reliability is still
  1109.             compromised by one byte control messages.
  1110.  
  1111.         XMODEM-1k XMODEM protocol with 1024 byte data packets, CRC-16, and one
  1112.             byte control messages, sometimes incorrectly called ymodem.
  1113.  
  1114.         YMODEM YMODEM is a batch file transfer protocol with pathname, date,
  1115.             file length and other file data in block 0, CRC-16 default, and
  1116.             optional 1024 byte packets.  Many programs claiming to support
  1117.             YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc                         Chapter 6 Rosetta Stone
  1121.  
  1122.  
  1123.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                   20
  1125.  
  1126.             -k and rx commands with these XMODEM mutants.
  1127.  
  1128.         XOFF, XON ASCII control characters control the flow of data.  XOFF
  1129.             (Ctrl-S) stops and XON (Ctrl-Q) resumes the flow of data.  Chapter
  1130.             37 provides an ASCII code chart with the names for the control
  1131.             characters.
  1132.  
  1133.         ZCOMM is a shareware (User Supported) subset of PCDOS Professional-
  1134.             YAM.
  1135.  
  1136.         ZMODEM An advanced file transfer protocol with simplified human
  1137.             interface, crash recovery, high speed streaming, sensitive 32 bit
  1138.             CRC, command download, security features, and important file
  1139.             management functions.
  1140.  
  1141.         {arg1 | arg2} One of the arguments separated by | is required.
  1142.  
  1143.         []  Optional argument.
  1144.  
  1145.         *   The special symbol * denotes features not included in ZCOMM.  **
  1146.             Denotes features not included in userialized (unregistered) copies
  1147.             of ZCOMM.
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1180.  
  1181.  
  1182.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                   21
  1184.  
  1185.         7.  INSTALLING ZCOMM
  1186.  
  1187.         If you have registered your copy of ZCOMM, make yourself a working
  1188.         copy of the ZCOMM distribution disk using the DOS diskcopy command.
  1189.         Keep the distribution disk in a safe place away from nasty killers
  1190.         such as disk drives, displays, computers, magnets, motors, and coffee
  1191.         cups.  The only time the distribution diskette should be out and about
  1192.         is when you are cloning your working copies.
  1193.  
  1194.  
  1195.         7.1  Installation from Registration Disk
  1196.  
  1197.         Before installing ZCOMM, you may wish to create a directory for the
  1198.         ZCOMM files.  If so, you must include this dorectory in the DOS PATH.
  1199.         Otherwise the files may be extracted to the root directory.
  1200.  
  1201.         The ZCOMM software files are contained in the ZCOMMEXE.ZIP and
  1202.         ZCOMMHLP.ZIP archives on the distribution disk.  Use a standard
  1203.         "unzip" program such as PKUNZIP to extract files from these archives.
  1204.  
  1205.         The putsnp program inserts your ZCOMM Serial-Number-Password (ZSNP)
  1206.         into your working copiy of ZCOMM.  Installing a legal serial number
  1207.         suppresses the pause after the opening message, enlarges the circular
  1208.         buffer, and enables new commands.  The putsnp program prompts for your
  1209.         Serial/Number/Password (SNP) of the form X123456789.  Putsnp checks
  1210.         for keyboarding mistakes and then verifies that you understand and
  1211.         agree to the licensing conditions.  When you understand and agree to
  1212.         the licensing conditions, respond with yes (not just y).
  1213.  
  1214.         Then putsnp prompts for the name of a file to insert the serial number
  1215.         into.  This should be a ZCOMM.EXE file that you have transferred to a
  1216.         scratch disk, or to an appropriate directory on your hard disk.  Do
  1217.         not write on the distribution diskette unless a nuclear attack is in
  1218.         progress.
  1219.  
  1220.         After inserting the serial number in the given file, putsnp asks if
  1221.         you wish to change the default value for the phone directory pathname
  1222.         (string parameter phones).  This is normally /PHODIR.t.  If you wish
  1223.         to keep the phones file elsewhere, answer "yes".[1] Putsnp then
  1224.         searches for the location in your copy of ZCOMM that contains this
  1225.         information.  When found, you may enter a new pathname,[2] up to 64
  1226.         characters.
  1227.  
  1228.  
  1229.         __________
  1230.  
  1231.          1. The default value may also be overidden with the PHONES DOS
  1232.             environment variable.
  1233.  
  1234.          2. Such as c:/zcomm/PHODIR.t.
  1235.  
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  1239.  
  1240.  
  1241.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                   22
  1243.  
  1244.         Afterwards, you should copy the help processor files YHP.EXE and
  1245.         ZMANH.HLP from the disk.
  1246.  
  1247.  
  1248.         7.2  Installation from ZCOMM*.ARC
  1249.  
  1250.  
  1251.         If you are using the software provided in ZCOMM*.ARC, be sure to save
  1252.         the original files for backup, and pass them on to your friends to
  1253.         fill their communications needs.  There are currently three ZCOMM
  1254.         archive files:
  1255.  
  1256.           + ZCOMMEXE.ARC contains the executable program and demonstration
  1257.             files.
  1258.  
  1259.           + ZCOMMDOC.ARC contains this documentation.
  1260.  
  1261.           + ZCOMMHLP.ARC contains ZCOMM's tree structured help file and random
  1262.             access flash-up help processor.
  1263.  
  1264.  
  1265.         7.3  Installation Continued
  1266.  
  1267.  
  1268.         The second order of business is to read this manual.  There is just no
  1269.         way you can get your money's worth out of ZCOMM without reading, or at
  1270.         least carefully scanning, this manual.  After all, didn't you get
  1271.         ZCOMM because you needed something more powerful than that cumbersome,
  1272.         unreliable, brain-damaged menu driven crock you've been using?
  1273.         (Perhaps you shouldn't answer that question just yet ...)
  1274.  
  1275.         You can then edit PHODIR.t to suit your own needs by inserting
  1276.         directory entries for the systems you wish to call and changing the
  1277.         phone numbers, account numbers, and passwords on the "standard"
  1278.         entries for popular timesharing services that you have accounts with.
  1279.         Be sure to check the setup entry and make any changes you feel
  1280.         appropriate.  Once you have the "feel" of ZCOMM, you will want to
  1281.         remove the automatic menu invocation at the end of the setup directory
  1282.         entry.
  1283.  
  1284.         Chapter 10 gives a line by line tutorial for setting up your telephone
  1285.         directory assuming you are using a standard modem.
  1286.  
  1287.         If you are using a computer that runs at non standard clock rates
  1288.         (e.g., 8 mHz 8088 instead of 4.77 mHz) or with an enhanced CPU chip
  1289.         (NEC V20), you will need to set special values for the a and b numeric
  1290.         parameters as described in Chapter 24.
  1291.  
  1292.         **** WARNING **** Although ZCOMM is well behaved as communications
  1293.         programs go, some memory resident programs, special keyboard
  1294.         modifiers, print spoolers, or special display drivers, may cause
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc                      Chapter 7 Installing ZCOMM
  1298.  
  1299.  
  1300.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                   23
  1302.  
  1303.         problems.
  1304.  
  1305.         **** WARNING **** Since ZCOMM uses interrupts to read data from the
  1306.         serial ports, each serial port must be strapped for its proper
  1307.         interrupt vector.  Some communications programs assign both IRQ3 and
  1308.         IRQ4 while operating, so they will operate even if the serial ports
  1309.         are not strapped properly.  Since ZCOMM only assigns the interrupt
  1310.         vector of the port in use, incorrect IRQ level strapping will crash
  1311.         ZCOMM.  Check the serial port addresses and vectors with the
  1312.         information given ith the port command in Chapter 19 if you encounter
  1313.         trouble starting ZCOMM.
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc              Chapter 7 Your Telephone Directory
  1357.  
  1358.  
  1359.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                   24
  1361.  
  1362.         8.  YOUR TELEPHONE DIRECTORY
  1363.  
  1364.         ZCOMM's telephone directory is a big flexibility advantage over
  1365.         traditional communications programs which require one or more separate
  1366.         files for each system called, or limit directory information to little
  1367.         more than a telephone number.
  1368.  
  1369.         The telephone directory contains telephone numbers, login scripts, and
  1370.         telephone dialers.  The telephone directory is a plain ASCII text file
  1371.         which can be edited with standard text editors (brief, teco, EMACS,
  1372.         edlin, etc.).
  1373.  
  1374.         Normally, ZCOMM expects to find the telephone directory in the file
  1375.         /PHODIR.t on the current disk.  The pathname may be changed with the
  1376.         PHONES environment variable.  Forward slashes should be used to
  1377.         indicate directories.
  1378.  
  1379.         EXAMPLE: C>set PHONES=c:/yam/lib/PHODIR.t
  1380.  
  1381.  
  1382.         EXAMPLE: $ PHONES=/u/flashg/bin/phones.t; export PHONES (for Unix)
  1383.  
  1384.  
  1385.         The putsnp program may also be used to change ZCOMM's default
  1386.         Telephone Directory pathname.
  1387.  
  1388.         The call command connects to another computer.  When you give a
  1389.         call name command, ZCOMM prepares for a modem call and then searches
  1390.         the telephone directory file for a line starting with name.
  1391.  
  1392.         It is not necessary to type the entire name as it appears in the
  1393.         telephone directory.  ZCOMM will find the first entry that name is a
  1394.         prefix of.
  1395.  
  1396.         EXAMPLE: call cis
  1397.         Calls cis300 or cis1200 whichever appears first.
  1398.  
  1399.         When using two entries with similar names (such as "cis300" and
  1400.         "cis1200"), place the favorite entry first.  This way you can just
  1401.         type call cis to get the desired entry.
  1402.  
  1403.         If the search is successful, the call command copies the complete
  1404.         directory entry name to the remote string parameter, where it can be
  1405.         used for log entries and automatic password generation.  ZCOMM
  1406.         executes the commands on the rest of the line (if any), and on
  1407.         succeeding lines beginning with a space or tab, until the next
  1408.         Telephone Directory entry or a return command is seen.
  1409.  
  1410.         There is no arbitrary limit to the size of the telephone directory.
  1411.         Popular entries may be placed near the front to minimize searching
  1412.         time.  When desired, Scripts can be placed in separate files
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1416.  
  1417.  
  1418.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                   25
  1420.  
  1421.         referenced with a source command from the Telephone Directory entry.
  1422.  
  1423.         8.1  Taking a Shortcut with PHOMAST.T
  1424.  
  1425.         This starter script was written by Michael Ash of San Antonio, Texas.
  1426.         It is easy to configure and use by following the detailed instructions
  1427.         included in PHOMAST.DOC.
  1428.  
  1429.         Phomast features fully automated menu configuration, autospeed
  1430.         detection, and lots of slick coding examples. When run for the first
  1431.         time phomast will generate a new file called PROFILE.DAT containing
  1432.         specific configuration information.  When you enter 'yam' or 'zcomm'
  1433.         at the DOS prompt, the script will ask you a few questions to set up
  1434.         the configuration to include COM port identification and modem
  1435.         initialization, and you are ready to communicate immediately thanks to
  1436.         the power of the script language built into ZCOMM.
  1437.  
  1438.         Under COLORS, you may select the alternate screen colors. These will
  1439.         be automatically set by the menu configuration and only need to be
  1440.         changed if you don't like the default colors... To see the possible
  1441.         colors and their associated code numbers, from the command line prompt
  1442.         enter: 'gosub color' and hit return.
  1443.  
  1444.         Under MODEM SETUP, if your modem doesn't respond correctly to the
  1445.         defaults, just select another modem setup string.  A default modem
  1446.         string is already configured and will work in most cases if your modem
  1447.         accepts the Hayes command set.  Phomast assumes the modem has not
  1448.         locked its interface speed.
  1449.  
  1450.         To use phomast.t with Pro-YAM, you must first set the DOS PHONES
  1451.         environment variable.
  1452.  
  1453.         EXAMPLE: C>set PHONES=c:/yam/phomast.t
  1454.  
  1455.  
  1456.         8.2  Customizing PHONES.T
  1457.  
  1458.         Phones.t is the "industrial strength" prototype directory.  While not
  1459.         as easy to configure as phomast.t, it is powerful enough to fully
  1460.         exploit TrailBlazer and other complex modems.
  1461.  
  1462.         When ZCOMM begins execution, it searches the telephone directory for
  1463.         the setup entry.  (A directory entry has the entry name starting at
  1464.         the left margin.)
  1465.  
  1466.  
  1467.         The setup telephone directory in the distributed phodir.t file invokes
  1468.         a demonstration menu.  Once you have exercized the various
  1469.         demonstration possibilities, search for the xsetup telephone directory
  1470.         and change it to setup be removing the "x".  This will blank out the
  1471.         oroginal setup entry which appears later in the file.
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1475.  
  1476.  
  1477.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                   26
  1479.  
  1480.         setup     port 1
  1481.  
  1482.         The first line of the "setup" entry selects port 1.
  1483.  
  1484.              : if !c speed 1200 putw "ATZ\r"
  1485.  
  1486.         This line is commented out with a colon (:).  If the colon is removed,
  1487.         the speed is changed to 1200 and ZCOMM sends an initialization command
  1488.         to the modem if no carrier detect signal is present.  If a carrier
  1489.         detect signal is present (modem still connected to the remote
  1490.         computer), the speed is not changed, and no initialization command is
  1491.         sent to the modem.
  1492.  
  1493.              pd1; pz480
  1494.  
  1495.         enables incoming time/date information provided by the ZMODEM and True
  1496.         YMODEM protocols.  Time/date stamping of transmitted files provides
  1497.         many advantages over traditional protocols, including the ability to
  1498.         selectively transmit files if the source file is newer than receiver's
  1499.         copy.  The number in the pz480 command should represent the local time
  1500.         zone expressed as minutes behind GMT.[1]
  1501.  
  1502.         This line should be commented out with a leading colon (or removed) if
  1503.         you use a backup program that depends on the dates of files to
  1504.         determine which to save.
  1505.  
  1506.              set mprefix "ATDT"
  1507.  
  1508.         sets the string parameter mprefix to ATDT, allowing the modem to use
  1509.         tone (DTMF) dialing.  If your phone line requires pulse dialing,
  1510.         comment that line out (place a leading colon to make ZCOMM pass over
  1511.         it) and uncomment the line containig "ATDP".
  1512.  
  1513.              set l "1"; set m "1"
  1514.  
  1515.         The l and m string parameters support the dynamic selection of one or
  1516.         more ALDS alternate long distance carriers.  The default values for
  1517.         these parameters is the digit 1.
  1518.  
  1519.         When making entries in your telephone directory, use %l- for numbers
  1520.         with different area codes, and %m- for numbers with the same area code
  1521.         as yours.
  1522.  
  1523.         If you use a long distance credit card or sometimes dial out from
  1524.         hotel or PBX lines, be sure to modify the att, ddd, hotel9, and hotel8
  1525.  
  1526.  
  1527.         __________
  1528.  
  1529.          1. Pacific Standard Time is 480 minutes behind Greenwich Mean Time
  1530.  
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1534.  
  1535.  
  1536.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                   27
  1538.  
  1539.         telephone directory entries in phones.t to suit your needs.
  1540.  
  1541.         The set command sets the string parameter l (lower case L) to 1
  1542.         (number), providing for normal long distance access.  If you have an
  1543.         alternative long distance service, set this parameter to the required
  1544.         access string for that service.[2] The "set m 1" command sets the
  1545.         string parameter m to 1, providing for normal long distance access for
  1546.         numbers in your same area code.  If you have an alternative long
  1547.         distance service, set this parameter to the required access string for
  1548.         that service, plus your area code if required. (Some alternate long
  1549.         distance services require the area code for all calls, even those in
  1550.         your own area code.)
  1551.  
  1552.              set answerback "YOUR NAME CITY\r\n\21"
  1553.  
  1554.         Change the answerback setting to reflect your name.[3] Be sure to keep
  1555.         the \21 at the end of the string.[4]
  1556.  
  1557.         The next lines configure soft keys F3 to FS4.  Their functions are
  1558.         described at the end of Chapter 19.
  1559.  
  1560.              : display bell=visual
  1561.  
  1562.         Causes bell characters to be displayed as a flashing musical note
  1563.         instead of sounding.  If you want a silent bell, uncomment this line.
  1564.  
  1565.              set quitcmd "\003\336off\r"
  1566.  
  1567.         This string is sent to the remote before disconnecting when an ALT-Q
  1568.         is typed during a protocol file transfer.
  1569.  
  1570.              : set calllog c:/calllog
  1571.              : set rxlog c:/tmp/rxlog
  1572.              : set txlog c:/tmp/txlog
  1573.  
  1574.         The above lines set the pathnames for logs of calls, files received,
  1575.         and files transmitted.
  1576.  
  1577.              set f10 "@help"
  1578.              if fyamhelp.t set helpfile "yamhelp.t"
  1579.              if f/umanh.hlp set helpfile "@yhp /umanh.hlp"
  1580.  
  1581.  
  1582.         __________
  1583.  
  1584.          2. Use the "setsavenet" entry in PHODIR.t as a prototype.
  1585.  
  1586.          3. Some timesharing systems may require a specific answerback string.
  1587.  
  1588.          4. See Chapter 26 for a description character escapes.
  1589.  
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1593.  
  1594.  
  1595.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                   28
  1597.  
  1598.              if fumanh.hlp set helpfile "@yhp umanh.hlp"
  1599.  
  1600.         The above lines locate the help file and program F10 to summon the
  1601.         help processor if available.  These lines may be changed if you keep
  1602.         these files in other directories.
  1603.  
  1604.              : if dc ps4 pn2 pr97
  1605.  
  1606.         If a color display is used on DOS, uncommenting this line selects red
  1607.         status line (ps4), green normal text (pn2), and a blue/yellow for
  1608.         reverse video (pr97).  These colors may be more suitable than the
  1609.         default black and white.  Another possibility is "pn3" which selects
  1610.         blue-green for normal text.  You may wish to experiment with these
  1611.         values to find ones best suited for your particular combination of
  1612.         display equipment and visual preferences.  Changing the colors from
  1613.         time to time may prolong display tube life.  The colors Telephone
  1614.         Directory entry* displays the colors generated by the possible numeric
  1615.         parameter values:
  1616.  
  1617.         EXAMPLE: gosub colors
  1618.  
  1619.         Some programs, including the "DEC Store" demonstration, will not
  1620.         display exactly as intended with some combinations of the above
  1621.         display parameters.
  1622.  
  1623.         You may wish to keep your phone numbers etc.  in one file and relegate
  1624.         information specific to each computer to a separate file.  The setup
  1625.         entry in phones.t checks for the existience of a phones.ts file and
  1626.         executes it if found.
  1627.  
  1628.              set s0 ""
  1629.              setc pho "%PHONES\&s";  if f%pho source %pho
  1630.              if %s0 return
  1631.  
  1632.         The supplied phones.ts file is used on some of Omen's Unix and DOS
  1633.         systems, and may be used as an example.  On DOS, if you use VT100
  1634.         emulation with keyboard mapping most of the time, you can add the
  1635.         contents of the keyboard mapping file std.mk, xen.mk, or 101.mk to
  1636.         your phones.ts file.
  1637.  
  1638.         While editing your telephone directory, you might wish to add some
  1639.         entries for your favorite systems in the same format used by the
  1640.         "amrad", "amsat", or "denver" directory entries.
  1641.  
  1642.         When the PHODIR.t file is ready, type "ZCOMM<ENTER>" to run ZCOMM.
  1643.         ZCOMM will print several lines of greeting and then silently execute
  1644.         the commands in the setup directory entry.
  1645.  
  1646.         If ZCOMM can't open PHODIR.t, exit ZCOMM with "x<ENTER>" and copy
  1647.         PHODIR.t to the correct directory, or set the DOS PHONES environment
  1648.         variable to the actual pathname (see Chapter 16).  Also check that the
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  1652.  
  1653.  
  1654.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                   29
  1656.  
  1657.         DOS CONFIG.SYS files contains FILES=20 to allow ZCOMM a sufficient
  1658.         number of open files for proper script operation.  If using DOS 3.2 or
  1659.         later, you may need to add a STACKS line to your CONFIG.SYS file, as
  1660.         described in Chapter 34.
  1661.  
  1662.         EXAMPLE: STACKS=20,128
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc                  Chapter 8 Unleashing the MODEM
  1711.  
  1712.  
  1713.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                   30
  1715.  
  1716.         9.  UNLEASHING THE MODEM
  1717.  
  1718.         9.1  Hardware Interface
  1719.  
  1720.         ZCOMM accesses serial ports at the standard IBM COM1 and COM2
  1721.         addresses.  Zcomm also has definitions for COM3-COM18 as described
  1722.         under the port command.  The portx command may be used to access
  1723.         8250/16450/16550A type serial ports at non standard addresses.
  1724.  
  1725.         When a port is selected, a quick hardware check is made to verify the
  1726.         existence and minimal functionality of the port.  If this test fails,
  1727.         the message Port N Defective is displayed.  An incorrect port switch
  1728.         or strap (jumper) configuration is the usual cause of this message.
  1729.  
  1730.         This check does not guarantee the port is connected to the proper IRQ
  1731.         line.  If the port is not configured to use the proper IRQ line, the
  1732.         computer may lock up when the port is used.
  1733.  
  1734.         Some 8250 UART devices (used by serial interface adapters and internal
  1735.         modems) do not respond correctly when the software turns the
  1736.         transmitter interrupts on and off.  High speed communications programs
  1737.         such as ZCOMM require properly functioning UART chips.  We recommend
  1738.         the National Semiconductor NS16550A/NS16550FAN.
  1739.  
  1740.         9.2  MODEM environment variable
  1741.  
  1742.         The advanced dialing scripts use two script subroutines to generate
  1743.         dialing commands for your specific modem.  The top level routine is
  1744.         the adial subroutine in the main phones.t file.  The top level routine
  1745.         handles alternate number lists and operations pertinent to all modems.
  1746.  
  1747.         Adial uses the MODEM environment variable to identify the disk file
  1748.         containing the modem specific dialer.  The value inherited from the
  1749.         environment may be overridden with a set command.  Adial searches for
  1750.         this file in the directory specified by the lib string variable.  The
  1751.         following dialer files are currently provided in dialers.zoo.
  1752.         Additional dialers will be described in dialers.doc, part of the
  1753.         dialers.zoo archive.
  1754.  
  1755.         ax9624.t MicroCom AX/9624c with MNP Class 6.  This modem includes a
  1756.                 pseudo full duplex 9600 bps speed.
  1757.  
  1758.         hst.t   U S Robotics HST Dual Standard
  1759.  
  1760.         hu96.t  Hayes V series Ultra Smartmodem 9600 (v.32/v.42)
  1761.  
  1762.         hv96.t  Hayes V series Smartmodem 9600
  1763.  
  1764.         mmv32.t Multitech MultiModem V32 with MNP.
  1765.  
  1766.  
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc                  Chapter 9 Unleashing the MODEM
  1770.  
  1771.